package com.nidu.demo.oauth2.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.oauth2.model.OAuth2Approve;
import com.nidu.demo.oauth2.model.OAuth2ApproveCriteria;

import java.util.List;
import java.util.Set;

/**
 * OAuth2用户授权网关接口
 * 提供领域层对OAuth2用户授权的访问能力
 *
 * @author auto
 */
public interface OAuth2ApproveGateway {

    /**
     * 创建OAuth2用户授权
     *
     * @param approve OAuth2用户授权信息
     * @return 创建后的OAuth2用户授权
     */
    OAuth2Approve create(OAuth2Approve approve);

    /**
     * 更新OAuth2用户授权
     *
     * @param approve OAuth2用户授权信息
     * @return 更新后的OAuth2用户授权
     */
    OAuth2Approve update(OAuth2Approve approve);

    /**
     * 根据ID查询OAuth2用户授权
     *
     * @param id OAuth2用户授权ID
     * @return OAuth2用户授权信息
     */
    OAuth2Approve getById(Long id);

    /**
     * 根据用户ID和客户端ID查询OAuth2用户授权列表
     *
     * @param userId 用户ID
     * @param clientId 客户端ID
     * @return OAuth2用户授权列表
     */
    List<OAuth2Approve> getByUserIdAndClientId(Long userId, Long clientId);

    /**
     * 删除OAuth2用户授权
     *
     * @param id OAuth2用户授权ID
     */
    void deleteById(Long id);

    /**
     * 批量删除OAuth2用户授权
     *
     * @param ids OAuth2用户授权ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 列表查询
     * @param criteria 查询条件
     * @return OAuth2用户授权列表
     */
    List<OAuth2Approve> listByCondition(OAuth2ApproveCriteria criteria);

    /**
     * 分页查询
     * @param criteria 查询条件
     * @return 分页结果
     */
    PageResponse<OAuth2Approve> pageByCondition(OAuth2ApproveCriteria criteria);
}
